﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>Método getFunctionColumns (SQLServerDatabaseMetaData)</title>
    
    <link rel="stylesheet" type="text/css" href="../local/Classic.css">
      
    </link>
    
    <script src="../local/script.js">
      
    </script><script src="../local/script_main.js">&amp;nbsp;</script>
  </head>
  <body>
    <!--Topic built:04/01/2010 05:03:30-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="headerBold">Método getFunctionColumns (SQLServerDatabaseMetaData)</span>
          </td>
          <td align="right">
            
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      
        
        
    <font color="DarkGray">
      
    </font>
    <p />
    
    <p />
  
        <div id="introductionSection" class="section">
    <p>Recupera uma descrição do sistema do catálogo especificado - ou parâmetros de função do usuário e tipo de retorno. </p>
    <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
      Esse recurso começa com o Microsoft SQL Server JDBC Driver versão 2.0.<p />
    </div>
  </div><h1 class="heading">Sintaxe</h1><div id="syntaxSection" class="section"><div class="sampleCode"><span codeLanguage="other"><pre>
public ResultSet <b>getFunctionColumns</b>(java.lang.String <i>catalog</i>,
                       java.lang.String <i>schemaPattern</i>,
                       java.lang.String <i>functionNamePattern</i>
                       java.lang.String <i>columnNamePattern</i>)</pre></span></div><h1 class="heading">Parâmetros</h1><div id="parametersSection" class="section" name="collapseableSection">
    <content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">
        <i>catalog</i>
      </p>
      <p xmlns="">Uma <b>String</b> que contém o nome do catálogo. Se for uma cadeia de caracteres vazia "", o resultado incluirá as funções sem um catálogo. Se for <b>null</b>, o nome do catálogo não será usado para pesquisa.</p>
      <p xmlns="">
        <i>schemaPattern</i>
      </p>
      <p xmlns="">Uma <b>String</b> que contém o padrão de nome do esquema. Se for uma cadeia de caracteres vazia "", o resultado incluirá as funções sem um esquema. Se for <b>null</b>, o nome do esquema não será usado para pesquisa.</p>
      <p xmlns="">
        <i>functionNamePattern</i>
      </p>
      <p xmlns="">Uma <b>String</b> que contém o nome de uma função.</p>
      <p xmlns="">
        <i>columnNamePattern</i>
      </p>
      <p xmlns="">Uma <b>String</b> que contém o nome de um parâmetro.</p>
    </content>
  </div></div><h1 class="heading">Valor de retorno</h1><div id="returnValueSection" class="section" name="collapseableSection">
    <content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">Um objeto <a href="eaffcff1-286c-459f-83da-3150778480c9.htm">SQLServerResultSet</a>.</p>
    </content>
  </div><h1 class="heading">Exceções</h1><div id="exceptionsSection" class="section" name="collapseableSection">
    <content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">
        <a href="af5ef257-7cf6-4db3-b1ee-07d22d82bef1.htm">SQLServerException</a>
      </p>
    </content>
  </div><h1 class="heading">Comentários</h1><div id="remarksSection" class="section" name="collapseableSection">
    <content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">Este método <b>getFunctionColumns</b> é especificado pelo método <b>getFunctionColumns</b> na interface java.sql.DatabaseMetaData.</p>
      <p xmlns="">Esse método retorna apenas as funções e os parâmetros correspondentes ao nome do esquema e da função especificados, além do nome do parâmetro dentro do catálogo especificado.</p>
      <p xmlns="">Todas as linhas do conjunto de resultados incluem as seguintes colunas para uma descrição de parâmetro, uma descrição de coluna ou um tipo de retorno:</p>
      <table width="100%" cellspacing="0" cellpadding="0" border="1" style="background-color: #CCCCCC;" xmlns=""><tr>
            <th>
              Nome
            </th>
            <th>
              Tipo
            </th>
            <th>
              Descrição
            </th>
          </tr><tr>
          <td>
            <p>FUNCTION_CAT</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do banco de dados no qual a função reside.</p>
          </td>
        </tr><tr>
          <td>
            <p>FUNCTION_SCHEM</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O esquema da função.</p>
          </td>
        </tr><tr>
          <td>
            <p>FUNCTION_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome da função.</p>
          </td>
        </tr><tr>
          <td>
            <p>COLUMN_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome de um parâmetro ou coluna.</p>
          </td>
        </tr><tr>
          <td>
            <p>COLUMN_TYPE</p>
          </td>
          <td>
            <p>
              <b>short</b>
            </p>
          </td>
          <td>
            <p>O tipo da coluna. Pode ser um dos seguintes valores:</p>
            <ul><li>
                functionColumnUnknown (0): Tipo desconhecido.<br />
              </li><li>
                functionColumnIn (1): Parâmetro de entrada.<br />
              </li><li>
                functionColumnInOut (2): Parâmetro de entrada/saída.<br />
              </li><li>
                functionColumnOut (3): Parâmetro de saída.<br />
              </li><li>
                functionReturn (4): Valor de retorno da função.<br />
              </li><li>
                functionColumnResult (5): Um parâmetro ou uma coluna é uma coluna no conjunto de resultados.<br />
              </li></ul>
          </td>
        </tr><tr>
          <td>
            <p>DATA_TYPE</p>
          </td>
          <td>
            <p>
              <b>smallint</b>
            </p>
          </td>
          <td>
            <p>O valor do tipo de dados SQL de <b>Java.sql.Types</b>.</p>
          </td>
        </tr><tr>
          <td>
            <p>TYPE_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do tipo de dados.</p>
          </td>
        </tr><tr>
          <td>
            <p>PRECISION</p>
          </td>
          <td>
            <p>
              <b>int</b>
            </p>
          </td>
          <td>
            <p>O número total de dígitos significativos.</p>
          </td>
        </tr><tr>
          <td>
            <p>LENGTH</p>
          </td>
          <td>
            <p>
              <b>int</b>
            </p>
          </td>
          <td>
            <p>O comprimento dos dados em bytes.</p>
          </td>
        </tr><tr>
          <td>
            <p>SCALE</p>
          </td>
          <td>
            <p>
              <b>short</b>
            </p>
          </td>
          <td>
            <p>O número de dígitos à direita da vírgula decimal.</p>
            <p>
            </p>
          </td>
        </tr><tr>
          <td>
            <p>RADIX</p>
          </td>
          <td>
            <p>
              <b>short</b>
            </p>
          </td>
          <td>
            <p>A base para tipos numéricos.</p>
          </td>
        </tr><tr>
          <td>
            <p>NULLABLE</p>
          </td>
          <td>
            <p>
              <b>short</b>
            </p>
          </td>
          <td>
            <p>Indica se o parâmetro ou o valor de retorno pode conter um valor <b>null</b>. </p>
            <p> Pode ser um dos seguintes valores:</p>
            <ul><li>
                functionNoNulls (0): O valor NULL não é permitido.<br />
              </li><li>
                functionNullable (1): O valor NULL é permitido.<br />
              </li><li>
                functionNullableUnknown (2): Desconhecido.<br />
              </li></ul>
          </td>
        </tr><tr>
          <td>
            <p>REMARKS</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>Os comentários sobre uma coluna ou um parâmetro.</p>
          </td>
        </tr><tr>
          <td>
            <p>COLUMN_DEF</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O valor padrão da coluna.</p>
            <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
              Essas informações estão disponíveis com o SQL Server, sendo específicas do driver JDBC.<p />
            </div>
          </td>
        </tr><tr>
          <td>
            <p>SQL_DATA_TYPE</p>
          </td>
          <td>
            <p>
              <b>smallint</b>
            </p>
          </td>
          <td>
            <p>Essa coluna é a igual à coluna <b>DATA_TYPE</b>, exceto pelos tipos de dados <b>datetime</b> e ISO <b>interval</b>.</p>
            <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
              Essas informações estão disponíveis com o SQL Server, sendo específicas do driver JDBC.<p />
            </div>
          </td>
        </tr><tr>
          <td>
            <p>SQL_DATETIME_SUB</p>
          </td>
          <td>
            <p>
              <b>smallint</b>
            </p>
          </td>
          <td>
            <p>O subcódigo <b>datetime</b> ISO <b>interval</b> caso o valor <b>SQL_DATA_TYPE</b> seja <b>SQL_DATETIME</b> ou <b>SQL_INTERVAL</b>. Para tipos de dados diferentes de <b>datetime</b> e <b>interval</b> ISO, essa coluna é NULL.</p>
            <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
              Essas informações estão disponíveis com o SQL Server, sendo específicas do driver JDBC.<p />
            </div>
          </td>
        </tr><tr>
          <td>
            <p>CHAR_OCTET_LENGTH</p>
          </td>
          <td>
            <p>
              <b>int</b>
            </p>
          </td>
          <td>
            <p>O tamanho máximo dos parâmetros ou colunas binários ou baseados em caractere. Para outros tipos de dados, ele é NULL.</p>
          </td>
        </tr><tr>
          <td>
            <p>ORDINAL_POSITION</p>
          </td>
          <td>
            <p>
              <b>int</b>
            </p>
          </td>
          <td>
            <p>Para parâmetros de entrada e saída, ele representa a posição começando em 1. </p>
            <p>Para colunas do conjunto de resultados, é a posição da coluna no conjunto de resultados começando em 1.</p>
            <p>Para o valor de retorno, é 0.</p>
          </td>
        </tr><tr>
          <td>
            <p>IS_NULLABLE</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>Determina a nulidade de um parâmetro ou de uma coluna.</p>
            <p>Pode ser um dos seguintes valores:</p>
            <p>
              <b>YES</b>: O parâmetro ou a coluna pode incluir valores NULL.</p>
            <p>
              <b>NO</b>: O parâmetro ou a coluna não pode incluir valores NULL.</p>
            <p>Cadeia de caracteres vazia (""): Desconhecida.</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_TYPE_CATALOG_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do catálogo que contém o UDT (tipo definido pelo usuário).</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_TYPE_SCHEMA_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do esquema que contém o UDT (tipo definido pelo usuário).</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_UDT_CATALOG_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O UDT (tipo definido pelo usuário) do nome totalmente qualificado.</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_UDT_SCHEMA_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do catálogo em que é definido um nome da coleção de esquemas XML. Se não for possível localizar o nome do catálogo, essa variável conterá uma cadeia de caracteres vazia.</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_UDT_ASSEMBLY_TYPE_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do esquema no qual é definido um nome da coleção de esquemas XML. Se não for possível localizar o nome do esquema, essa cadeia de caracteres estará vazia.</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_XML_SCHEMACOLLECTION_CATALOG_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome de uma coleção de esquemas XML. Se não for possível localizar o nome, essa cadeia de caracteres estará vazia.</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_XML_SCHEMACOLLECTION_SCHEMA_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do catálogo que contém o UDT (tipo definido pelo usuário).</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_XML_SCHEMACOLLECTION_NAME</p>
          </td>
          <td>
            <p>
              <b>String</b>
            </p>
          </td>
          <td>
            <p>O nome do esquema que contém o UDT (tipo definido pelo usuário).</p>
          </td>
        </tr><tr>
          <td>
            <p>SS_DATA_TYPE</p>
          </td>
          <td>
            <p>
              <b>tinyint</b>
            </p>
          </td>
          <td>
            <p>O tipo de dados do SQL Server usado por procedimentos armazenados estendidos.</p>
            <p>
              <b>Observação</b>   Para obter mais informações sobre os tipos de dados retornados pelo SQL Server, consulte "Tipos de dados (Transact-SQL)" nos Manuais online do SQL Server.</p>
          </td>
        </tr></table>
    </content>
  </div><span id="seeAlsoSpan"><h1 class="heading">Consulte também</h1></span><div id="seeAlsoSection" class="section" name="collapseableSection"><a href="8b8049d0-8c6d-4476-866b-098709f37eec.htm">Classe SQLServerDatabaseMetaData</a><br /><a href="327ba0bc-438a-494c-b119-1cd4a096bb58.htm">Membros de SQLServerDatabaseMetaData</a><br /><br /></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]-->
      <div id="footer" class="section">
        
		<hr />
		
		<span id="fb" class="feedbackcss">
			
			
		</span>
		
		<a href="9bad553b-9e70-4696-8499-2e35f772a1e0.htm">
			
			© 2010 Microsoft Corporation. Todos os direitos reservados.
		</a>
 	
	
      </div>
    </div>
  </body>
</html>